home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / complib / RGG.z / RGG
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. ____RRRRGGGGGGGG((((3333FFFF))))                                                              ____RRRRGGGGGGGG((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      RGG, SRGG  -  EISPACK routine.  This subroutine calls the recommended
  10.      sequence of subroutines from the eigensystem subroutine package (EISPACK)
  11.      to find the eigenvalues and eigenvectors (if desired) for the REAL
  12.      GENERAL GENERALIZED eigenproblem  Ax = (LAMBDA)Bx.
  13.  
  14.  
  15. SSSSYYYYNNNNOOOOPPPPSSSSYYYYSSSS
  16.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee  rrrrgggggggg((((nnnnmmmm,,,, nnnn,,,, aaaa,,,, bbbb,,,, aaaallllffffrrrr,,,, aaaallllffffiiii,,,, bbbbeeeettttaaaa,,,, mmmmaaaattttzzzz,,,, zzzz,,,, iiiieeeerrrrrrrr))))
  17.           iiiinnnntttteeeeggggeeeerrrr          nnnnmmmm,,,, nnnn,,,, mmmmaaaattttzzzz,,,, iiiieeeerrrrrrrr
  18.           ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn aaaa((((nnnnmmmm,,,,nnnn)))),,,,bbbb((((nnnnmmmm,,,,nnnn)))),,,,aaaallllffffrrrr((((nnnn)))),,,,aaaallllffffiiii((((nnnn)))),,,,bbbbeeeettttaaaa((((nnnn)))),,,,zzzz((((nnnnmmmm,,,,nnnn))))
  19.  
  20.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssrrrrgggggggg((((nnnnmmmm,,,, nnnn,,,, aaaa,,,, bbbb,,,, aaaallllffffrrrr,,,, aaaallllffffiiii,,,, bbbbeeeettttaaaa,,,, mmmmaaaattttzzzz,,,, zzzz,,,, iiiieeeerrrrrrrr))))
  21.           iiiinnnntttteeeeggggeeeerrrr          nnnnmmmm,,,, nnnn,,,, mmmmaaaattttzzzz,,,, iiiieeeerrrrrrrr
  22.           rrrreeeeaaaallll             aaaa((((nnnnmmmm,,,,nnnn)))),,,,bbbb((((nnnnmmmm,,,,nnnn)))),,,,aaaallllffffrrrr((((nnnn)))),,,,aaaallllffffiiii((((nnnn)))),,,,bbbbeeeettttaaaa((((nnnn)))),,,,zzzz((((nnnnmmmm,,,,nnnn))))
  23.  
  24.  
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      On Input
  28.  
  29.      NNNNMMMM must be set to the row dimension of the two-dimensional array
  30.      parameters as declared in the calling program dimension statement.
  31.  
  32.      NNNN is the order of the matrices  A  and  B.
  33.  
  34.      AAAA contains a real general matrix.
  35.  
  36.      BBBB contains a real general matrix.
  37.  
  38.      MMMMAAAATTTTZZZZ is an integer variable set equal to zero if only eigenvalues are
  39.      desired.  Otherwise it is set to any non-zero integer for both
  40.      eigenvalues and eigenvectors.  On Output
  41.  
  42.      AAAALLLLFFFFRRRR and  ALFI  contain the real and imaginary parts, respectively, of
  43.      the numerators of the eigenvalues.
  44.  
  45.      BBBBEEEETTTTAAAA contains the denominators of the eigenvalues, which are thus given
  46.      by the ratios  (ALFR+I*ALFI)/BETA.  Complex conjugate pairs of
  47.      eigenvalues appear consecutively with the eigenvalue having the positive
  48.      imaginary part first.
  49.  
  50.      ZZZZ contains the real and imaginary parts of the eigenvectors if MATZ is
  51.      not zero.  If the J-th eigenvalue is real, the J-th column of  Z
  52.      contains its eigenvector.  If the J-th eigenvalue is complex with
  53.      positive imaginary part, the J-th and (J+1)-th columns of  Z  contain the
  54.      real and imaginary parts of its eigenvector.  The conjugate of this
  55.      vector is the eigenvector for the conjugate eigenvalue.
  56.  
  57.      IIIIEEEERRRRRRRR is an integer output variable set equal to an error completion code
  58.      described in section 2B of the documentation.  The normal completion code
  59.      is zero.  Questions and comments should be directed to B. S. Garbow,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ____RRRRGGGGGGGG((((3333FFFF))))                                                              ____RRRRGGGGGGGG((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      APPLIED MATHEMATICS DIVISION, ARGONNE NATIONAL LABORATORY
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.